package cn.iocoder.yudao.module.member.level.service;

import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
import cn.iocoder.yudao.module.api.member.user.enums.MemberExperienceBizTypeEnum;
import cn.iocoder.yudao.module.member.level.dal.dataobject.MemberLevelDO;
import cn.iocoder.yudao.module.member.level.vo.MemberLevelCreateReqVO;
import cn.iocoder.yudao.module.member.level.vo.MemberLevelListReqVO;
import cn.iocoder.yudao.module.member.level.vo.MemberLevelUpdateReqVO;
import cn.iocoder.yudao.module.member.user.vo.MemberUserUpdateLevelReqVO;
import jakarta.validation.Valid;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 用户等级 Service 实现类
 *
 * @author owen
 */
public interface MemberLevelService {

    /**
     * 创建用户等级
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createLevel(@Valid MemberLevelCreateReqVO createReqVO);

    /**
     * 更新用户等级
     *
     * @param updateReqVO 更新信息
     */
    void updateLevel(@Valid MemberLevelUpdateReqVO updateReqVO);

    /**
     * 删除用户等级
     *
     * @param id 编号
     */
    void deleteLevel(Long id);

    /**
     * 获得用户等级
     *
     * @param id 编号
     * @return 用户等级
     */
    MemberLevelDO getLevel(Long id);

    /**
     * 获得用户等级列表
     *
     * @param ids 编号
     * @return 用户等级列表
     */
    List<MemberLevelDO> getLevelList(Collection<Long> ids);

    /**
     * 获得用户等级 Map
     *
     * @param ids 编号
     * @return 用户等级列表 Map
     */
    default Map<Long, String> getLevelMap(Collection<Long> ids) {
        List<MemberLevelDO> levels = getLevelList(ids);
        return CollectionUtils.convertMap(levels, MemberLevelDO::getId, MemberLevelDO::getName);
    }

    /**
     * 获得用户等级列表
     *
     * @param listReqVO 查询参数
     * @return 用户等级列表
     */
    List<MemberLevelDO> getLevelList(MemberLevelListReqVO listReqVO);

    /**
     * 获得指定状态的用户等级列表
     *
     * @param status 状态
     * @return 用户等级列表
     */
    List<MemberLevelDO> getLevelListByStatus(Integer status);

    /**
     * 获得开启状态的用户等级列表
     *
     * @return 用户等级列表
     */
    default List<MemberLevelDO> getEnableLevelList() {
        return getLevelListByStatus(CommonStatusEnum.ENABLE.getStatus());
    }

    /**
     * 修改用户的等级
     *
     * @param updateReqVO 修改参数
     */
    void updateUserLevel(MemberUserUpdateLevelReqVO updateReqVO);

    /**
     * 增加用户经验
     *
     * @param userId     用户ID
     * @param experience 经验
     * @param bizType    业务类型
     * @param bizId      业务编号
     */
    void addExperience(Long userId, Integer experience, MemberExperienceBizTypeEnum bizType, String bizId);

    /**
     * 获得用户等级享受折扣
     *
     * @param userId 用户编号
     * @return 享受折扣
     */
    int getMemberLevelDiscountPercentByUserId(Long userId);

}
